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ABSTRACT 

The  aim  of  this  thesis  is  to  design  and  implement  a 
graohic  subsystem  for  a  graphic  display  terminal  with  conic 
section  capabilities.  The  display  terminal  with  its  associ- 
ated peripheral  hardware  is  connected  to  a  PDP-11/50  com- 
puter . 

The  basic  concents  and  design  principles  of  graphic  sys- 
tems are  discussed.  A  brief  description  is  given  of  the 
particular  hardware  configuration  of  the  Conograph i c- 1 2 
display  system  as  installed  at  the  Naval  Postgraduate 
School.  Concepts  incorporated  in  the  designed  implementa- 
tion are  explained.  Recommendations  are  included  for  possi- 
ble future  extensions  of  the  system's  capabilities. 


TABLE  OF  CONTENTS 

ACKNOWLEDGEMENT 6 

Ij       INTRODUCTION 7 

II.  INTERFACE  DESIGN  CONCEPTS 8 

A.  UNIVERSAL  GRAPHIC  LANGUAGE 8 

B.  GOALS  OF  A  GRAPHIC  SYSTEM 10 

C.  SOFTWARE  DESIGN 12 

III.  HARDWARE  ENVIRONMENT 14 

IV.  CONIE  -  CONOGRAPHIC  INTERFACE  EFFORT 17 

A.  INITIALIZING  AND  TERMINATING 17 

B.  DIRECT  GRAPHICS IB 

C.  VIRTUAL  GRAPHICS 18 

D.  ALPHANUMERICS 22 

E.  CONTROL  ROUTINES 24 

V.  RECOMMENDATIONS 25 

VI.  CONCLUSIONS 26 

APPENDIX  A  -  USER'S  MANUAL 27 

LIST  OF  REFERENCES 87 

INITIAL  DISTRIBUTION  LIST 88 


ACKNOWLEDGEMENT 


I  wish  to  express  my  deeoest  appreciation  to  my  thesis 
advisor*  Gary  V .  Raetz*  for  his  effort*  guidance*  and  pati- 
ence. His  knowledge  and  assistance  have  been  invaluable  in 
developing  and  installing  the  CONIE  System. 

I  also  wish  to  thank  my  son  Kristofer  for  his  many  dis- 
t  ract  ions. 


I.   INTRODUCTION 


The  purpose  of  this  thesis  is  to  desian  and  implement  a 
graphic  subsystem  for  a  graphic  display  terminal  with  conic 
section  capabilities.  A  literature  search  was  performed  to 
determine  the  desirable  features  of  a  graphic  system  and 
plausible  means  of  implementation.  The  resulting  imple- 
mented design  provides  the  applications  orogrammer  with  a 
library  packaae  of  general  ourpose  subroutines  which  con- 
struct the  commands  for  the  Conoaraoh  i  c- 1 2.  Interactive 
Graphic  Display  System. 

Ihe  Conograph i c- 1 2  Display  System,  as  installed  at  the 
Naval  Postgraduate  School*  is  a  display  terminal  interfaced 
with  a  PDP-11/50  computer.  The  terminal  system  includes  an 
alphanumeric  keyboard/  special  program  function  keyboard* 
joystick*  and  extended  symbol  capability.  This  terminal 
draws  points*  straiaht  lines/  characters*  circles/  arcs* 
ellipses/  and  conic  curves.  As  a  result/  major  reductions 
in  the  amount  of  data  reguired  to  draw  a  qiven  picture  are 
made  possible.  Data  compression  means  that  pictures  take 
less  CPU  time  to  manipulate/  significantly  less  storage 
soace/  and  substatially  less  time  to  transmit  from  computer 
memory  to  display  aevice  f  3 1  • 


II.   INTERFACE  DESIGN  CONCEPTS 


A.  UNIVERSAL  GRAPHIC  LANGUAGE 


One  of  the  major  obstacles  in  defining  a  aeneral  graphic 
subsystem  is  that »  even  among  the  exoertS/  there  is  no  con- 
sensus of  opinion  on  what  its  capabilities  should  be.  Many 
can  point  out  various  functions  which  they  would  like  to  see 
in  the  system,  but  each  person  desires  different  functions. 
The  one  point  on  which  most  do  aaree  is  that,  at  this  tine* 
simplicity  is  more  iimortant  than  efficiency  in  a  graphic 
language.  Once  a  languaae  has  been  conceived  and  can  be 
used  by  a  wide  variety  of  oeoolpr  then  the  efficiency  of  the 
language  can  be  extended. 

Wiseman  says  it  is  a  mistake  f  o  say  that  "because  we  are 
dealing  with  graDhical  thinas*  there  is  a  need  to  invent  a 
new  language/  or  perhaps  to  embellish  a^  existina  one" [4], 
Ahat  is  needed  is  a  rich  languaae  able  to  express  and  mani- 
pulate complex  data  structures.  The  task  of  generating  pic- 
tures as  a  Dvproduct  is  easy?  the  complexity  in  graphics 
arises  from  the  problems  of  data  descriotion  and  task  coor- 
d  i  n  a  t  ion. 

William  Newman  claims  w  e»  alreadv  have  a  general  purpose 
graphic  language  in  FORTRAN  IV.  '"est  proposed  graphics 
packages  are  based  on  F0RTR4N  IV,  even  thounh  it  is  not  a 
particularly   good   1 anauaae   CM .    It  nas  to  be  considered 


universal  because  everyone  uses  it  [41 .  Extrapolating  from 
this  arguement  anv  language  with  input/output  capabilities 
could  be  considered  a  general  purpose  graphic  language  if 
there  are    no  particular  requirements  that  it  must  meet. 

Several  of  the  exoerts  believe  that  it  is  impossible  to 
define  a  universal  araphics  language  only  because  graphics 
is  not  understood  well  enouah.  For  instance*  we  do  under- 
stand arithmetic  well  enough  so  nobody  questions  the  useful- 
ness of  a  universal  arithmetic  language.  Rosenfeld  suggests 
that  "we  can  inculcate  araphical  thinking  at  a  stage  as 
early  as  arithmetic  thinking  is  now  inculcated/  and  let  the 
next  generation  design  the  universal  graphic  1 anguage" [4]  . 

Wells  considers  set  theory  a  universal  graphic  language. 
Unordered  sets  appear  in  many  languages.  The  ordered  struc- 
tures* lists  and  arrays*  in  proaramming  languages  are  just 
the  sequences  of  set  theory;  the  procedures  are  the  func- 
tions of  set  theory;  and  lines  are  naturally  considered  to 
be  sets  of  Doints.  Reliance  should  be*  wherever  Dossible* 
on  established  general  mathematical  symbolism  and  conven- 
tions* rather  than  considering  particular  extensions  to 
computer-oriented  languages  that  have  been  developed  with 
economics  of  machine  operation  as  a  prime  consideration. 
Lanauaaes  should  first  be  desianed  for  man-to-man 
communication*  with  concern  for  the  efficiency  or  implemen- 
tation on  various  machines  coming  later  [U]  » 

Since   there  are       different   areas   of   araphics    with 


different  requirements  oerhaps  it  would  be  more  practical  to 
define  these  areas  and  their  requirements.  The  different 
areas  of  graphics  include:  off-line  input/  recognition,  and 
scene  analysis?  interactive  input?  plotting  output;  line 
drawings?  and  shaded  oictures.  Most  applications  will  be 
concerned  primarily  with  one  of  these  graphic  areas  although 
some  applications  may  deal  with  a  combination  of  areas,  such 
as  the  field  of  interactive  design  which  uses  a  combination 
of  interactive  inout  and  line  drawings.  The  specific  needs 
of  each  area  should  be  researched  and  defined.  Then  a 
language  can  be  designed  for  each  area  rather  than  attempt- 
ing to  desion  one  language  for  all  araphics  areas. 


B.  GOALS  OF  A  GRAPHIC  SYSTEM 

Graphic  terminals  are  particularly  well  adapted  t o  the 
many  problems  which  do  not  yield  exact  solutions  bv  a  oiven 
algorithm.  Such  oroblems  often  require  the  user's  direct 
intervention  at  different  staqes  in  the  computation,  man- 
to-machine  dialogue,  in  order  to  obtain  satisfactory  solu- 
tions. The  efficiency  of  such  a  dialogue  demands  a  rapid, 
synthetic  representation  of  results  as  well  as  a  simple, 
flexible,  and  convenient  means  of  intervention  at  the  user's 
disposal.  Graphic  terminals  allow  quick  visualization  of 
diaqrams,   araphs,   or   any   picture  which  would  be  far    more 
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easily  interoreted  than  the  usual  tabulated  numerical 
results.  Moreover,  these  terminals,  being  eauipped  with 
joystick,  hardware  zoom,  and  alDhanumeric  and  function  key- 
boards, become  accessible  to  non-Drogrammers  (21  • 

Ease  of  use  is  one  of  the  Drincipal  goals  of  a  araphic 
system.  Conseauent 1 y ,  a  graphic  system  reguires  certain 
properties.  First,  concepts  linked  with  the  use  of  graphic 
terminals  have  to  be  clearly  set  aoart.  These  basic  con- 
cepts must  appear  in  the  structure  of  the  application  pro- 
gram, making  the  system  a  "guide  for  good  programming"  [2] • 
Second,  the  number  of  instructions  related  to  interactive 
graDhics  should  be  as  small  as  possible.  The  goal  is  to 
make  the  user's  manual  a  handy  reference  guide  rather  than 
an  in-depth  study. 

Few  general  purpose  graohic  systems  would  be  able  to 
satisfy  comoletely  all  the  reauirements  of  a  particular 
aDplication.  Therefore,  an  applications  Drogrammer  is 
freauently  obliged  to  develop  a  SDecific  system  which  con- 
tains the  features  neeoed  to  resolve  his  own  particular 
problem.  In  the  graphic  subsystem  for  the  Conog raph i c- 1 2  an 
attemot  is  made  to  orovide  as  b»*oad  a  variety  of  general 
purpose  graphic  tools  as  is  needed  to  aive  the  applications 
programmer  access  to  all  of  the  terminal's  capabilities. 
The  modular  nature  of  subroutine  calls  facilitates  modifica- 
tion. This  includes  the  deletion  of  functions  which  through 
utilization   are  determined  to  be  non-useful,  as  well  as  the 
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addition  of  new  functions  which  are  deemed  desirable.  For 
this  reason,  a  list  of  subroutine  calls  becomes  a  more  effi- 
cient means  of  i mo  1 ement at i ng  an  interface  than  the  "syntac- 
tic extension  of  an  existing  language"  recommended  by 
Boul 1 ier  (21  . 


C.  SOFTWARE  DESIGN 

The  software  suDDort  reauired  to  utilize  graphic  devices 
such  as  the  Conoqraph i c-1 2 ,  include  machine-dependent 
transmission;  interrupt  handling  routines,  and  processors 
for  user-oriented  lanauages.  The  design  of  graphic  programs 
begins  with  an  evaluation  of  other  software  support  avail- 
able to  the  computer  system  and  the  deoree  of  interaction 
reguired  to  incorporate  the  aranhic  devices  15], 

A  multi-level  design  approach  is  used  in  the  develooment 
of  graphic  software.  There  are  qenerally  considered  to  be 
four  levels.  Level  one  includes  subroutines  which  are 
dependent  on  the  hardware  characteristics  of  the  araphic 
device.  They  perform  primitive  operations.  Software 
developed  at  this  level  orovides  the  basic  tools  for  pro- 
gramminq  at  the  higher  levels.  Level  two  programs  combine 
the  facilities  available  from  the  ooeratinq  system  with  the 
hardware-oriented  proorams  of  level  one.  This  combination 
provides  the  nroqrams  and  user-oriented  1 anguaaes  to  be  used 
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at  level  three.  Software  development  at  level  three 
includes  user-oriented  subroutines  which  are  capable  of 
organizing  buffer  and  file  management  routines*  and  can  for- 
mulate graDhical  instructions  and  data  transmission.  Level 
four  progamming  is  application  progams  which  are  directed 
toward  the  suoport  of  the  non-proarammer  [51. 

The  lowest  level  of  this  multi-level  design  is  illus- 
trated in  this  project.  It  involves  efforts  to  provide  an 
efficient  interface  for  the  handling  of  signals  between  the 
computer  and  the  araohic  devices.  Progressively  higher  lev- 
els of  software  comoonents  can  then  be  developed  to  increase 
the  productivitv  and  utility  of  the  total  system. 

The  programming  activities  of  this  project  are  primarily 
in  the  category  of  level  one  software  desian  -  primitive* 
hardware-oriented  subroutines.  At  the  most  primitive  level* 
subroutines  are  used  to  Droduce  the  object  code  which  is 
reguired  to  generate  images.  Examoles  include  code  to  plot 
a  ooint*  display  a  character*  draw  a  vector*  etc.  At  this 
level  all  the  parameters  are  device-oriented.  That  is*  the 
subroutines  work  with  the  parameters  reguired  by  the 
Conograph i c-1 2 .  Using  other  subroutines*  the  screen  point 
coordinates  and  slope  values  are  converted  into  the  device- 
oriented  curve  parameters.  User-oriented  subroutines  con- 
vert the  user's  coordinates  to  screen  coordinates. 
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III.   HARDWARE  ENVIRONMENT 

The  Conograph i c- 1 2  Interactive  Graphic  Display  System 
includes  raster  scan  CRT  display/  alphanumeric  keyboard/ 
program  function  keyboard/  joystick/  extended  symbol  capa- 
bility/ and  hardware  zoom.  The  coordinate  system  inherent 
in  the  hardware  is  an  integer  address  space  with  the  x  and  v 
coordinate  values  ranging  from  -4096  to  4095.  The  hardware 
includes  scale  and  offset  registers  which  provide  the  caoa- 
bility  of  varying  the  oortion  of  address  space  which  is 
disolayed  on  the  screen.  rthen  the  scale  factor  is  one  and 
the  offsets  are  zero/  the  x  coordinates  from  zero  to  2047 
and  the  y  coordinates  from  zero  to  1536  are  visible  on  the 
sc  reen . 

The  storage  tube  terminal  has  the  basic  capabilities  of 
displaying  vectors  and  alDhanumeric  characters.  Once  writ- 
ten the  disolay  remains  visible  until  erased.  It  is  not 
necessary  to  continually  regenerate  the  output  data  or 
refresh  the  screen.  The  oicture  is  actually  drawn  on  the 
target  of  a  video  memory  utilizing  random  X-Y  deflection. 
The  target  of  the  video  memory  is  electronically  scanned  to 
produce  the  video  signal  which  the  raster  scan  CRT  displays. 
The  generator/  which  suDplies  the  X-Y  deflection  signals/ 
draws  conic  curves  in  response  to  digital  parameters  sup- 
plied from  a  comouter  [31. 

The  alphanumeric  keyboard  has  the   ability   to   generate 
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all  two  hundred  fifty-six  8-bit  character  codes.  The  key- 
board generates  one  hundred  twenty-eiqht  ASCII  character 
codes,  and  there  is  an  additional  key  to  force  the  parity 
bit  to  zero  or  one.  This  extends  the  range  of  codes  that 
may  be  generated  to  the  full  two  hundred  fifty-six.  The 
alphanumeric  keyboard  can  be  enabled/disabled  by  a  command 
from  the  user's  proaram  in  the  host  computer.  When  enabled* 
striking  a  kev  generates  an  interrupt*  passing  the  keycode 
to  the  computer.  For  the  ooeration  of  various  additional 
keys  provided  on  the  keyboard*  reference  the  Conograoh i c-1 2 
System  Reference  Manual  13], 

The  proaram  function  keyboard  consists  of  thirty-two 
function  keys  which  produce  codes  that  m  a  v  be  interpreted  by 
a  program  in  the  host  comouter.  The  resulting  action  is 
totally  dependent  on  the  proaram. 

The  joystick*  when  enabled  by  a  program*  provides  cursor 
positioning  control  directly  to  the  user.  A  program  may 
obtain  this  positional  information  by  reading  the  graphic 
display  terminal's  registers.  Other  information  obtainable 
from  the  registers  are:  offset*  scale*  dash  pattern*  dash 
freauency*  and  selected  intensity. 

The  hardware  zoom  is  completely  independent  of  any  pro- 
gram. It  provides  the  user  with  the  capability  of  dynami- 
cally scaling  and  oosi t ioninq  the  displayed  picture  in  order 
to  view  a  select  portion. 

The  extended  symbol  capability  provides  the   possibility 
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of  having  SDecial ized  fonts  or  sD?cial  sets  of  symbols  for 
particular  applications.  A  standard  ASCII  character  font  is 
provided.  It  is  implemented  in  a  4  K  P  0  M  which  is  addressed 
as  a  particular  range  of  the  terminal's  memory.  When  the 
terminal  is  in  alphanumeric  mode  and  an  8-bit  character  code 
is  receivedr  execution  of  the  instructions  locatea  at  the 
address  indicated  bv  the  su^  of  the  contents  of  the  font 
oase  register  plus  the  the  8-bit  character  code  is  per- 
formed. In  the  standard  ASCII  character  font  ROM,  this 
first  instruction  is  "  j  u  m  d  t  o  symbol  subroutine"  [  1 ] •  Thus 
the  first  25  6  locations  in  the  font's  a  d  a  r  e  s  s  srace  comorise 
a  jumo  table.  The  symbol  subroutine  is  composed  of  short 
graphic  commands #  t*us  all  capabilities  of  the  terminal  are 
accessable  exceot  the  hardware  dasn  pattern  ana  selectable 
intensity.  All  addressina  witnin  a  font  is  relative  to  the 
value  in  the  font  oase  reaister.  The  address  soace  of  a 
font  is  limited  to  4  0  G  6  locations  starting  with  the  aariress 
in  the  font  base  reaister  [ d ] .  Special  fonts  ana  svmbol 
sets  mav  be  implemented  in  me  sa^e  manner  as  that  just 
described  for  the  sta^aard  ASCII  character  set.  The  partic- 
ular font  to  be  utilized  is  selected  bv  setting  the  font 
base  register.  Tne  default  sett inq  of  the  font  base  regis- 
ter is  the  ASCII  *ont. 
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IV.   CONIE  -  CONOGRAPHIC  INTERFACE  EFFORT 

The  Conograoh i c-12  Interface  is  a  hierarchical  set  of 
subroutines  which  can  be  divided  into  four  general  areas: 
Direct  Graphics*  Virtual  Graphics*  A 1 phanumeri cs>  and  Con- 
trol Routines.  The  routines  in  all  these  areas  provide  the 
user  interface.  This  is  where  the  functions  as  conceived  bv 
the  user  are  translated  into  functions  which  are  acceptable 
to  the  computer.  To  provide  ease  of  use*  every  operation 
which  is  functionally  different  is  referred  to  by  a  seperate 
subroutine  call.  Each  subroutine  call  and  its  arguements 
are  described  in  Aooendix  A  of  this  thesis. 


A.  INITIALIZING  AND  TERMINATING 

To  ensure  a  prooer  starting  seauence*  an  initializinq 
routine  is  Drovided  and  must  be  called  before  usina  any 
other  CONIE  routine.  The  initial  state  is  defined  by  the 
following  four  requirements:  Cursor  and  beam  are  at  the  HOME 
position(lower  left-hand  corner);  Terminal  is  in  qraphic 
mode?  The  scaling  is  set  to  unity  and  rotation  and  offset 
are  at  zero;  Character  size  is  set  to  two*  "normal"  condi- 
tion. This  initializinq  routine  ooens  files?  therefore*  it 
must  not  be  recallec  prior  to  calling  the  terminatinq 
routine.   The  terminatinq  routine  closes  the  files. 
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B.  DIRECT  GRAPHICS 

Direct  araoMcs  utilizes  the  coordinate  svstem  provided 
bv  the  Conoaraoh i c- I  2  hardware.  Included  are  scalinq  and 
offsetting.  The  facilities  for  utilizing  the  conic  section 
capabilities  are  provided.  These  include  routines  to  draw 
curves  given  the  points  and  slopes  uniguely  describing  the 
particular  curve  desired.  Curves  may  be  uniguely  defined 
by:  two  points  and  their  associated  slope  (see  figure  1)* 
three  Doints  and  the  sloDe  associated  with  one  of  these 
points  (see  figures  2*3  and  4) ,  or  three  points  where  the 
slope  at  the  intermediate  Doint  is  egual  to  the  slooe  of  the 
chord  joining  the  endpoints  (see  figure  5).  Also  included 
are  routines  for  drawing  circles*  ellipses*  and  guarters 
thereof.  These  figures  may  be  specified  by  their  center  and 
length  of  axes*  or  their  center  and  one  endpoint  of  each 
axis  (  see  f  i  gure  6) . 


C.  VIRTUAL  GRAPHICS 

To  escaoe  the  size  constraints  of  the  terminal  screen* 
the  concept  of  virtual  coordinates  was  implemented.  The 
virtual  coordinate  system  is  an  imaginary  surface  bounded 
only  by  the  range  of  the  floating  point  numbers  of  the  com- 
puter system  beinq  used.   The  user  may  construct   a   drawing 
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FIG      3 


FIG     4 
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FIG      5 


FIG      6 
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in  any  section  of  the  virtual  coordinate  system  that  is 
desired.  The  units  of  the  system  have  no  physical  dimen- 
sions associated  with  them.  Such  a  dimension  may  be  arbi- 
trarily assumed  at  the  user's  convenience.  Before  con- 
structing the  drawing,  the  user  specifies  which  portion  of 
the  virtual  coordinates  system  to  be  viewed  by  callinq  a 
routine. 

The  virtual  coordinate  system  facilities  are  similar  to 
those  available  with  direct  coordinates.  There  is  one  not- 
able exception:  Virtual  coordinates  permit  distortion  -  that 
is*  the  X  and  Y  units  may  be  of  different  sizes.  This 
capability  is  not  available  with  direct  coordinates.  The 
distortion  capability  precludes  permitting  lengths  as  param- 
eters for  routines  (see  figure  7).  Therefore*  the  routines 
avail  able  with  virtual  coordinates  are  only  a  subset  of 
those  available  with  direct  coordinates. 


D.  ALPHANUMERIC^ 

Capability  is  provided  for  sendinq  a  string  of  charac- 
ters. A  character  strino/  as  defined  in  the  HC"  1 anauage 
[7],  is  any  number  of  characters*  excluding  the  null  charac- 
ter. However*  the  null  character  must  be  included  at  the 
end  of  the  string  to  indicate  termination  of  the  character 
string.   A  string  of  characters  will  normally  be  interpreted 
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FIG      7 
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by  the  Conoqraph i c -1 2  as  belongina  to  the  ASCII  character 
setr  unless  a  different  set  of  symbols  has  been  defined  and 
the  font  base  register  has  been  loaded  to  point  to  this 
other  set  of  symbols. 

There  are  two  modes  for  sendinq  a  string  of  characters 
to  the  terminal.  The  difference  between  Template  Mode  and 
Alphanumeric  Mode  is  only  a  scale  factor  of  eight? 
al phanumer i cs  are    drawn  scaled  down  by  a  factor  of  eight. 


E.  CONTROL  ROUTINES 

There  are  various  control  routines  which  provide  for 
such  functions  as  re-initialization;  erasure?  ringing  the 
keyboard  bell?  selecting  dash  patterns  and  frequencies?  and 
setting  scale  factor,  angle  of  rotation,  center  of  rotation, 
and  reflection  bits.  Other  control  routines  orovide  for  the 
reading  of  the  terminal's  reaisters/  keyboard  characters* 
and  the  proaram  function  keys.  A  control  routine  which 
utilizes  the  recursive  orooerty  of  the  "C"  language  allows 
large  complex  structures  to  be  built  up  in  modular  fashion 
from  small  simple  structures  [U.  At  the  lowest  level  of 
complex  structures/  the  extended  svmbol  capaoilty  can  be 
utilized  to  further  simolifv  the  building  of  structures. 
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V.   RECOMMENDATIONS 

An  assembler  op  very  powerful  editor  for  building 
extended  symbol  sets  would  be  a  very  useful  extension  to  the 
present  implementation.  This  is  needed  to  assist  the  pro- 
grammer in  building  the  jumo  table  with  the  proper 
addresses . 

The  addition  of  higher  level  routines  to  plot  arrays* 
and  to  provide  curve-fitting  and  data  smoothina  is  recom- 
mended. The  capability  of  plotting  arrays  is  convenient  in 
a  variety  of  aopl i cat i ons .  Curve-fitting  and  data  smoothing 
combine  to  take  full  advantage  of  the  Conograph i c- 1 2 '  s  capa- 
bilities so  that  data  compression  can  be  fully  exploited. 

The  different  graphic  display  terminals  at  the  Naval 
Postgraduate  School  have  uniauely  individual  hardware 
features.  However,  in  time  the  capabilities  provided  by 
their  software  systems  will  achieve  a  high  dearee  of  over- 
lap. At  that  time  it  will  be  feasible  to  design  and  imple- 
ment a  pre-orocessor  extension  to  the  "C"  language  f7]  which 
will  perform  the  translation  to  the  particular  routines  for 
the  graphic  display  terminal  selected  at  compile  time.  A 
program  can  then  be  written  which  can  be  executed  on  any  or 
all  of  the  different  araohic  display  terminals  simply  by 
recomp  i  1  i  ng  [8]  . 
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VI.   CONCLUSIONS 

The  Conograph i c-1 2  Interface  Effort  has  been  designed 
and  implemented.  As  a  result  of  the  programming  effort 
involved  in  the  production  of  CON  IE*  the  user  can  fully 
utilize  the  Conograph i c-1 2  and  its  associated  peripheral 
hardwa  re . 
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APPENDIX  A  -  USER'S  MANUAL 
A.  INTRODUCTION 

This  manual  lists  in  alohabetical  order  the  subroutine 
calls  used  for  sending  graphic  commands  to  the  Cono- 
graphic-12  terminal.  Prior  to  the  execution  of  a  program 
utilizing  these  calls,  the  terminal  should  be  turned  on  and 
placed  in  non-local  mode  utilizing  the  switch  provided  on 
the  terminal's  alphanumeric  keyboard. 

The  various  graphic  facilties  available  are  curve  draw- 
ing, scaling,  offsetting  automatic  dash  pattern  for  draw- 
ing, reflections,  variable  intensity,  and  rotation.  Also 
available  is  the  ASCII  character  font  and  the  capability  of 
defining  additional  fonts. 

To  utilize  the  various  subroutines  provided,  a  program 
is  written  usino  costartC)  as  the  first  graphic  call  and 
cgfiniO  as  the  last.  The  particular  picture  or  subpictures 
to  be  displayed  are  best  described  in  functions  defined  by 
the  user  utilizina  the  drawing  commands  such  as  cgline, 
camove,  cgelosa,  or  cgcr22.  There  are  a  variety  of  addi- 
tional drawina  commands  from  which  the  user  may  select  those 
best  suited  to  his  needs.  Character  outout  intermixed  with 
drawing  commands  can  be  accomplished  simply  by  using  the 
cgalph  command.  If  the  convention  is  followed  of  utilizing 
a  seoerate  function  for  each  suboicture,  then  the  positonina 


21 


of  each  subpicture  can  be  easily  accomplished  using  commands 
like  cgdrawr.  This  also  simplifies  the  defining  of  subpic- 
tures  since  each  has  its  own  set  of  coordinate  axes.  Thus 
the  user  can  define  independent  objects  for  display  and 
later  accomplish  the  relative  Dositioning. 

An  illustration  of  how  cgdrawr  may  be  utilized  is  in  the 
segmentation  of  a  display  object  into  its  component  parts* 
which  may  have  their  own  symmetry.  A  simple  example  would 
be  the  wheel  of  a  vehicle.  For  such  a  case  a  user  would 
write  a  function  defining  a  wheel »  oerhaps  with  coordinates 
(0,0)  for  the  center  hub  of  the  wheel.  The  vehicle  body 
could  be  defined  in  a  seperate  function  with  the  coordinates 
(0/0)  oossibly  at  one  of  the  corners  of  the  vehicle.  When 
drawing  the  complete  vehicle  with  wheels*  the  sequence  of 
cgmove  followed  with  cgdrawr  would  be  utilized.  The  call  to 
cgmove  would  be  used  to  position  the  beam  at  the  end  of  the 
vehicle's  axle.  The  command  cadrawr  would  be  called  with 
the  wheel  function  and  the  proper  coordinates  of  the  wheel's 
center  as  defined  by  the  wheel  function  as  parameters.  This 
would  effectively  place  the  wheel  on  the  end  of  the 
veh  i  c 1 e ' s  axle. 

The  parameters  of  scale,  rotation,  and  reflection  for 
cadrawr  provide  additional  flexibility.  With  the  scale 
parameter  available,  a  user  need  not  concern  himself  with 
making  the  units  uniform  for  all  subpictures.  Instead  he 
may  utilize  the  most   convenient   units   for   each   seoerate 
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suboicture  and  then  scale  aoproori at e 1 y •  The  rotation 
parameter  enables  the  user  to  define  a  subpicture  at  the 
angle  where  its  coordinates  are  most  easily  expressed*  and 
then  rotate  the  subpicture  to  provide  the  proper  display. 
The  reflection  parameter  Drovides  the  capability  for  exact 
90  degree  rotations  and  subpicture  inversions.  The  center 
for  all  of  these  transformations  is  the  beam  position  when 
the  cgdrawr  command  is  executed. 

Control  of  the  manner  in  which  input  coordinate  data  is 
to  be  interoreted  is  provided  by  the  subroutines  cginpfm  and 
cgvcord.  The  routine  cainofm  permits  the  user  to  declare 
whether  his  coordinate  data  will  be  expressed  in  normal 
Cartesian  coordinate  format  or  in  coordinates  relative  to 
the  beam  position.  The  routine  cgvcord  enables  the  user  to 
specify  a  floating  Doint  coordinate  system.  The  information 
the  user  provides  cgvcord  is  used  to  set  the  parameters 
necessary  for  convertina  floating  point  coordinates  into  the 
integer  coordinate  system  of  the  screen. 

Additional  subroutines  orovide  control  of  various 
hardware  features*  some  of  which  are  as  simple  as  ringing 
the  keyboard  bell.  Others  Drovide  the  input  of  information 
from  the  various  auxiliary  devices*  including  the 
alphanumeric  and  program  function  keyboards.  The  dash  pat- 
tern and  selectable  intensity  ar*  controlled  by  the  routines 
cadofis  and  cgdsi.  The  routine  cadpfis  is  utilized  to  set 
the   pattern   ana  intensity  available.   The  routine  cqdsi  is 
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inserted  at  appropriate  places  in  the  drawing  commands  to 
turn  on  or  off  the  utilization  of  the  dash  pattern  or 
selected  intensity.  The  ability  to  erase  either  the  full 
screen  or  a  select  object  is  provided  by  cgerase.  In  order 
to  erase  a  particular  object/  cqerase  is  called  for  the 
appropriate  setting.  The  commands  for  drawing  the  object 
are  the  re-executed  to  accomplish  the  erasure,  after  which 
cgerase  is  recalled  to  reset  to  normal  drawing. 

The  user's  program  is  compiled,  specifying  that  the 
Conograoh i c- 12  library  be  included.  The  routines  available 
in  this  library  and  the  parameters  they  reguire  are  detailed 
on  the  followinq  oages.  The  naming  convention  followed  is 
that  all  start  with  the  letters  "eg"  so  that  the  user  can 
easily  avoid  collision  of  names.  Also  all  routines  using 
virtual  coordinates  start  with  "cav"  to  signify  that  their 
coordinate  parameters  are  virtual  and  must  therefore  be 
floating  point  numbers. 


B.  SAMPLE  PROGRAM 


//  This  program  draws  a  simple  sketch  of  a  ferris  wheel 

//  This  function  defines  the  labels  to  be  placed  on  each  car 
char  *num ( i 1 
i  n  t  i  ; 
{ 

Sw  i  t ch  (  i  )  { 

case  0:  return (  "0M  )  ; 

case  I:  ret  urn (  "  t  "  )  ; 

case  2:  ret  urn ( "?"  )  ; 
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case 
case 
case 
case 
case 
} 


return("3H) 
return("4" ) 
ret  urn ("5") 
pefurn("6" ) 
return("7"  ) 


) 


//This  function  draws 
car ( i ) 
int  i  ; 

< 

cgc  i  re (0,0,5) ; 

cgelpsa(0,-50,  0 
cgmove ( -5 , -80)  ; 
cgal Dh (num ( i  )  )  ; 
> 


the  car  and  calls  the  label  function 


0,20,50)  7 

/  /  Position  for  the 

//  Outout  the  label 


label 


int  i  ; 

//  This  function  draws  the  arms  of  the  ferris  wheel 

//  and  Dositions  the  cars  at  their  ends 

arm ( a  , b ) 

int  a, O? 

< 

cgelpsa(0,0,0.0,a,b); 

cgmove(a,0);         //  Move  to  the  end  of  the  arm 

cgdr awa ( 1 . 0 , 0 . 0 , 0 , 0 , 0 , c a r , i ,  0 ) ; 

/ /  Set  an    upriqht  orientation  for  the  car 
} 


//    Thi 

//  DOS 

mainO 

i 

cgs 

cgc 

cgm 

for 

// 

cgf 


s  is  the  main  oroqram  which  initiates  and 
itions  the  oicture  on  the  screen 


tart ("  f err i  s") ; 
rsr(O)  ; 

ove(1023,800); 
( i  =  o  ;  i  <  8  ;  i  *  ♦  ) 
Draw  the  arm  in 
i  n  i  ( )  ; 


cqdrawrd. 0,0. 39269,  i,0,0, arm, 500, 50); 
all  its  eight  reflections 
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cga 1 ph 


cqal ph 


NAME: 

cgalph  -  emit  character  string  in  alphanumeric  mode 

SYNOPSIS: 

cpa 1 ph ( a ) 
char  a  []  ; 


DESCRIPTION: 

This  routine  places  the  terminal  in  alphanumeric 
mode  and  then  sends  a  character  string  to  the  terminal. 
It  returns  the  beam  position  to  a  Doint  one  line  down 
from  the  previous  position  and  returns  the  terminal  to 
the  previous  graphic  mode. 


nu 1 1 -t  erm  i  nat  ed 
Conogr aoh  i  c - 1 2 


character   string   to   be   sent 


to 


SEE  ALSO: 
cgtol t 
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cgbe  1  1 


cgbel 1 


NAME: 

cqbel 1  -  ring  keyboard  bell 
SYNOPSIS: 

cgbel 1  () 

DESCRIPTION: 

This  routine  rings  the  keyboard  bell  . 
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cqc i  re 


cqc l re 


NAME: 

egcire  -  draw  a  circle 
SYNOPSIS: 

cqc  i  pc (a#b* t ) 

i  nt  a,b, t  ; 

DESCRIPTION: 

This  routine  draws  a  circle  when   given   the   center 

point   and   the   radius.  The  coordinates  of  the  center 

point  are  shown  by  a>b.  The  radius  is   defined   by   the 
value  of  t . 

a       x  coordinate  of  center 

b       y  coordinate  of  center 

t   -    radi  us  of  circle 

SEE  ALSO: 
cgc  i  rq 
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cac i rq 


cgc i ra 


NAME: 

cgcirg  -  draw  circle  Quarters 

SYNOPSIS: 

cgc  i  rg(a*b*dr*g#se) 
i  nt  a  fb ,dr ,qJ 
float  *se; 


DESCRIPTION: 

This  routine  draws  auarters  of  circles  when  given 
the  values  for  the  center  point*  a  point  on  the  circle* 
the  direction  in  which  to  draw  from  this  point/  and  the 
number  of  quarters  to  be  drawn.  The  present  position  of 
the  beam  defines  a  point  on  the  circle.  The  center 
point  is  given  by  the  coordinates  a  r  b  .  The  direction  in 
which  to  draw  from  the  Dresent  position  is  defined  bv 
dr.  The  number  of  quarters  to  be  drawn  is  shown  by  q# 
where  one  quarter  is  assumed  and  3  draws  a  full  circle. 
The  address  where  the  value  of  the  ending  slope  will  be 
returned  is  defined  by  se. 

a       x  coordinate  of  center 

b       y  coordinate  of  center 

dr  -    direction  of  drawing 
0 :     draw  clockwise 
1:     draw  counterclockwise 

g   -    number  of  additional  quarters 
0:     one  quarter  only 
1  :     semi -c  i  re  1  e 

2:     two  additional  quarters*  total  three  quarters 
3:     full  circle 

se  -    address  of  floatinq  ooint  variable  where  endina  slope 
can  be  ret  urned 


SEE  ALSO: 


cac i ra 
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cgc  rsr 


cgc  rsr 


NAME: 

cgcrsr  -  turn  cursor  on  or  off 

SYNOPSIS: 

cqc  rsr (o ) 
i  n  t  O  ? 


DESCRIPTION: 

This  routine  enables/disables  the  joystick.  tohen 
enabled*  the  user  can  directly  control  the  positioning 
of  the  cursor  by  manioulatinq  the  joystick. 

i   -    ac t  i  on  f 1 ag 

0:     disable  the  joystick 
1:     enable  the  joystick 


SEE  ALSO: 
cgrdcsr 
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cgcr22 


cgcr22 


NAME: 

cgcr22  -  draw  a  curve  given  2  points  and  2    slooes 

SYNOPSIS: 

cgcr<?2  (  x  *  y  *  sb»  se) 
i  nt  x , y  ; 

f 1  oat  sbfSe? 

DESCRIPTION: 

This  routine  draws  a  curve  when  given  two  points  on 
the  desired  curve  and  the  slopes  associated  with  these 
two  ooints.  The  beginning  point  of  the  curve  is  the 
present  oosition  of  fhe  beam.  The  coordinates  x>y 
define  the  endDoint.  The  slooe  of  the  beginning  point 
is  defined  by  sb.  The  slope  of  the  endpoint  is  given  by 
se. 

x  x  coordinate  of  the  endpoint 

y  v  coordinate  of  the  endpoint 

sb  -    slooe  of  the  curve  at  the  beginning  point 

se  -    slope  of  the  curve  at  the  endpoint 


DIAGNOSTICS: 

The  ambiguous  case  of  parameters  sb=se  outouts  a 
message  to  the  standard  output?  moves  to  the  specified 
endpoint/  and  returns  a  negative  value. 


SEE  ALSO: 

cgcr3bf   cgcr3e/   cgcr3i*   cgcr3m, 
cgvcr3e»  cgvcr3i,  cgvcr3m 


cgvcr22#    cavcr3b» 
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cac  r3b 


cgc  rib 


NAME: 

cgcr3b  -  draw  a  curve  given  3  points  and  beginning  slooe 

SYNOPSIS: 

cgc r3b (qf h , x , y , sbr se) 
int  g,  h  ,  x , y ; 
f 1  oat  sb , *se  ? 

DESCRIPTION: 

This  routine  draws  a  curve  when  given  three  points 
and  the  slooe  at  the  beainning  ooint.  The  beginning 
point  is  defined  by  the  present  position  of  the  beam. 
The  coordinates  of  the  intermediate  point  are  given  by 
g»h.  The  endooint  is  shown  by  the  coordinates  x*y.  The 
slooe  at  the  beginning  point  is  defined  by  sb.  The 
address  where  the  value  of  the  ending  slope  will  be 
returned  is  shown  by  se, 

g  x  coordinate  of  intermediate  point 

h  y  coordinate  of  intermediate  point 

x  x  coordinate  of  the  endooint 

y  y  coordinate  of  the  endooint 

sb  -    slope  of  the  curve  at  the  beginnina  Doint 

se  -    address  of  floatina  ooint  variable  where  ending  slope 
can  be  returned 

DIAGNOSTICS: 

If   the   parameters   describe  a    curve    with    an 

inflection   point/   a   message  is  outout  to  the  standard 

output/  the   beam   is   moved   to  the   endpointr   ana   a 
negative  value  is  returned. 


SEE  ALSO: 

cgcr22/   cgcr3e»   cacr3i,   cqcr3m, 
c  g  v  c  r  3  e  >  c  g  v  c  r*  3  i  /  cgvcr3m 


cavcr22/    cqvcr3br 
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cac  r3e 


cqc  r3e 


NAME: 

cgcr3e  -  draw  a  curve  qi ven  3  points  and  ending  slooe 

SYNOPSIS: 

cgcr3e (q»h,x,v>se) 
i  nt  g*  h  ,  x  ,  y  ', 
f 1  oat  se; 


DESCRIPTION: 

This  routine  draws  a  Curve  when  given  the 
coordinates  of  three  points  and  the  slope  at  the 
endpoint.  The  beainning  point  is  defined  by  the  present 
position  of  the  beam.  The  intermediate  point  is  shown 
bv  the  coordinates  g*h.  The  endpoint  is  defined  by  the 
coordinates  x»y.  The  slope  at  the  endpoint  is  given  by 
se . 

g  x  coordinate  of  intermediate  point 

h  y  coordinate  of  intermediate  point 

x  x  coordinate  of  the  endpoint 

y  y  coordinate  of  the  endpoint 


se  - 


slooe  of  the  curve  at  the  endpoint 


DIAGNOSTICS: 

If   the   parameters   describe  a    curve    with    an 

inflection   point*   a   message  is  outout  to  the  standard 

output*  the   beam   is   moved   to  the   endpoint*   and   a 
neaative  value  is  returned. 


SEE  ALSO: 

cqcr22,       cgcr3b»   cacr3i*   cqcr3mr 
cgvcr3e*  cgvcr3i*  cavcr3m 


cqvcr2?*    cgvcr3b* 
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cgc  r3i 


cgc  r3i 


NAME: 

cgcr3i  -  draw  a  curve  given  3   points   and 
s  1  ope 

SYNOPSIS: 

cgcr3i (g, h , x , y , si  r  se) 
int  g*  h , x , y ; 
float  s  i / *se; 


i  ntermedi  ate 


DESCRIPTION: 

This  routine  draws  a  curve  when  given  three  points 
and  the  slope  at  the  intermediate  point.  The  beginning 
point  is  defined  by  the  present  position  of  the  beam. 
The  intermediate  point  is  qiven  by  the  coordinates  g  /  h  . 
The  endooint  is  defined  by  the  coordinates  x,y.  The 
slope  at  the  intermediate  point  is  given  by  si.  The 
address  where  the  value  of  the  ending  slope  will  be 
returned  is  shown  bv  se. 

g       x  coordinate  of  intermediate  point 

h       y  coordinate  o*     intermediate  point 

x       x  coordinate  of  the  endpoint 

y  coordinate  o*  the  endpoint 

sloDe  of  the  curve  at  the  intermediate  point 


y 

s  i  - 

se  - 


address  of  floating  Doint  variable  where  ending  slope 
can  be  ret  urned 


DIAGNOSTICS: 

If   the   oarameters   describe  a    curve    with    an 

inflection   points   a   message  is  output  to  the  standard 

outout*  the   beam   is   moved   to  the   endpoint*   and   a 
negative  value  is  returned. 


SEE  ALSO: 

cgcr22,   cgcr3b#   cacr3e»   cgcr3mr    cgvcr22,    cgvcr3b* 


ao 


c  g  v  c  r  3  e »    c  g  v  c  r  3  i  ,    c  q  v  c  r  3  m 


a\ 


cqc  r  3m 


cqc  rim 


NAME: 


cgcr3m   -   draw   a   curve   given   3   points 
intermediate  at  the  relative  maximum 

SYNOPSIS: 


with    the 


cgcr3m(q/h,x*VfSe) 
i  nt  qfh,X;vJ 
float  *se; 


DESCRIPTION: 

This  routine  draws  a  curve  when  given  three  points 
where  the  slope  at  the  intermediate  ooint  is  egual  to 
the  slope  of  the  chord  joining  the  endpoints.  The 
beginning  point  "is  defined  by  the  Dresent  oosition  of 
the  beam.  The  intermediate  ooint  is  shown  by  the 
coordinates  g*h.  The  endpoint  is  defined  by  the 
coordinates  x  /  y .  The  address  where  the  value  of  the 
ending  slope  will  be  returned  is  shown  by  se. 

g   -    x  coordinate  of  intermediate  point 

h        y  coordinate  of  intermediate  point 

x       x  coordinate  of  the  endpoint 


y  - 


y  coordinate  of  the  endooint 


se  -    address  of  floatina  ooint  variable  where  endina  slope 
can  be  returned 


SEE  ALSO: 

cgcr22,       cgcr3b»   cgcr3e>   cgcr3i, 
cavcr3e»  cgvcr3i,  cgvcr3m 


cgvcr22f    cgvcr3b* 
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cgdof  i  s 


cgdpf  i  s 


NAME: 

cgdpfis  -  set  dash  pattern  and  fregugncy  and   selectable 
i  nt ens  i  t y 

SYNOPSIS: 

cgdpf  i  s (p, f  ,  i ) 
i  nt  ot  f t  i  ? 


DESCRIPTION: 

This  routine  sets  dash  pattern,  dash  frequency*  and 
selected  intensity  level.  Draw  commands  are  affected 
only  if  cgdsi  has  been  called  setting  dash  and/or 
intensity  select. 

i  -  12  bit  value  definina  dash  pattern,  1  specifies 
intensification  and  0  specifies  blanking;  for  example, 
07777  would  Oe  a  solid  line,  0  would  be  a  blank  line, 
05252  would  be  short  dashes,  077  would  be  long  dashes. 

4  bit  value  (0-15),  this  controls  the  frequency  of 
the  dash  oattern  thus  determining  the  length  of  the  dash 
cor resDondi ng  to  each  bit  in  the  pattern  (note:  other 
scale  factors  do  not  affect  the  dash  oattern) 

H    bit  value  (0-15),  sets  the  grey  scale  level  of   the 
selectable  intensity,  0  is  dimmest,  15  is  briahtest,  and 
12  is  the  grey  scale  level  of  the  normal  intensity 


SEE  ALSO: 
cgds  i 


a3 


cadrawa 


cgdrawa 


NAME: 

cgdrawa  -  set  new  orientation  for  user  function 

SYNOPSIS: 

cgdrawa(s»ar  r ,  x  ,  y  , f ,ac»av) 
int(*f)()faCf8Vf r>Xfy; 
f 1  oat  s  f a; 

DESCRIPTION: 


This  routine  resets  the  orientation  th 
user's  function  with  the  two  arauements. 
means  of  the  Conog raph i c- 1 2  hardware  regis 
limited  to  the  range  of  l/6a  to  63  63/64 
the  previous  orientation  is  restored. 
function  f  is  defined  by  the  user  to 
suboicture  he  desires.  The  parameters  ac 
Dassed  to  the  user's  function  so  tha 
parameters.  If  more  than  two  parameters  a 
non-integer  parameters  are  desired,  the 
provided  can  be  used  to  pass  a  count  and  a 
array  of  parameters. 


en   calls   the 

Scaling  is  by 

t  e  rs  therefore 

Upon  return 

The    user  '  s 

draw  what  ever 

and   av  are 

t   i  t  may  have 

re  des  i  red/  or 

two  parameters 

pointer  to  an 


scale  to  be  applied 


a 


angle  of  desired  rotation  expressed  in  radians 


reflection  desired 

0 :  no  reflection 

1 :  reflect  about 

2:  reflect  about 

3:  ref 1 ect  about 

4 :  ref 1 ect  about 

5  :  pi  f2.    rotation 

6:  oi/2  rotation 

7 :  ref 1 ect  about 


x-ax i s 

y-ax  i  s 

both  axes i 

pi /4  line 

counterc 1 ockwi  se 

c 1 ockwi  sp 

3/4  pi  line 


(pi  rotation) 


x        x  coordinate  which  will  correspond  with  present   beam 
position  and  be  the  center  of  reflection  ana  rotation 

y       y  coordinate  which  will  correspond  with  present   beam 
position  and  be  the  center  of  reflection  and  rotation 

f   -    user  defined  function 


aa 


ac  -    first  arquement  for  user  function 
av  -    second  arquement  for  user  function 

SEE  ALSO: 

cgdrawr,  cgvdrwa^  cqvdrwr 
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cgdrawr 


cgdrawr 


NAME: 


cgdrawr 

or  i  ent  at  i  on 


set 


orientation 


rel at  i  ve 


to 


present 


SYNOPSIS: 

cgdrawr(Sf3f  r,xc»yc» frac^av) 
int  ( * f ) ( ) t ac i av , r ,  xc t yc  ; 
float  s , a? 


DESCRIPTION: 
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s   -    scale  to  be  aDclied 

a   -    angle  of  desired  rotation  expressed  in  radians 

r   -    reflection  desired 

0 :  no  reflection 

1:  reflect  about  x-axis 

2:  reflect  about  y-axis 

3:  reflect  about  both  axes,  (oi  rotation) 

4:  reflect  about  Di/4  line 

5:  pi/2  rotation  counterclockwise 

6:  pi/2  rotation  clockwise 

7:  reflect  about  3/4  oi  line 

x   -    x  coordinate  which  will  corresnond  with  present   beam 
position  and  be  the  center  of  reflection  and  rotation 

y   -    v  coordinate  which  will  correspond  with  present   beam 


'4  6 


position  and  be  the  center  of  reflection  and  rotation 
f   -    user  defined  function 
ac  -    first  arguement  for  user  function 
av  -    second  arguement  for  user  function 

SEE  ALSO: 

cgdrawar  cgvdrwa*  cgvdrwr 
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cads  i 


cgds  i 


NAME: 

cqdsi  -  select  dash  and/or  intensity 

SYNOPSIS: 

cgds  i (df  i ) 
i  n  t  d  f  i  ; 


DESCRIPTION: 

This  routine  determines  whether   susequent   drawinq 

commands   are   to  be  dashed  and/or  at  normal  or  selected 

intensity.   This  routine, is  used   in   conjunction   with 

cgpdfis    which    sets   the  particular   oattern   and/or 
intensity  which  is  used. 


d   -    drawinq  mode  selection 
0:     set  solid  drawinq 
1:     set  dashed  drawinq 

i   -    intensity  selection 

0:     utilize  normal  intensity  (12) 

1:     utilize  the  presently  set  selectable  intensity 


SEE  ALSO: 
cqpdf  i  s 
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cgel psa 


cgel Dsa 


NAME: 


cgelpsa  -  draw  an  ellipse  given  center  and  axes   lengths 
and  or i  ent  at  i  on 


SYNOPSIS 


cgelpsa(a*b#r/mj ,mn) 
int  a  »  b  »  m  j , mn ; 
float  r; 


OESCRIPTION: 

This  routine  draws  an  ellipse  when  aiven  the  center 
point*  lengths  of  the  two  axes*  and  the  orientation. 
The  center  point  is  given  by  the  coordinates  arb.  The 
length  of  the  major  semi-axis  is  defined  by  maj.  The 
length  of  the  minor  semi -axis  is  defined  by  min.  For 
orientation*  the  anale  between  the  major  axis  and  the 
horizontal  is  given  bv  r  and  is  written  in  radians. 

i   -    x  coordinate  of  center 


b   -    y  coordinate  of  center 

r   -    angle  of  major  axis  orientation  with  resoect 
x-axis  expressed  in  radians 

mj  -    major  semi-axis  lenqth 

mn  -    minor  semi-axis  lenqth 


to   the 


SEE  ALSO: 

cgelpse*  cgelosa*  cgvelog 
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cgel pse 


cgel pse 


NAME: 

cgelpse  -  draw  an  ellipse  given  center,  one  axis  end  and 
other  axis  1 engt  h 

SYNOPSIS: 

cgelpse(a*b,xe>ye, la) 
i  nt  a/b  ,  xe»  ye»  1  q', 


DESCRIPTION: 

This  routine  draws  an  ellipse  when  given  the  center 
point*  one  axis  endpoint  and  the  length  of  the  other 
semi-axis.  The  center  point  is  shown  by  the  coordinates 
a*b.  The  coordinates  of  the  axis  endpoint  are  given  by 
xe>  ye.  The  lenqth  of  the  other  semi-axis  is  qiven  by 
lg. 

a   -  x  coordinate  of  center 

0  y  coordinate  of  center' 

x  x  coordinate  of  one  semi-axis  endpoint 

y   -  y  coordinate  of  one  semi-axis  endpoint 

lg  -  length  of  other  se^i-axis 

SEE  ALSO: 

cgelpsa,  cgelpsa/  cgvelpa 
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cgel osq 


cgel psa 


NAME: 

cgelpsq  -  draw  elliose  quarters 

SYNOPSIS: 

cge1osq(afbf xefye»q»se) 
i  nt  a,b *  xe fve rQt 
float  *se; 

DESCRIPTION: 

This  routine  draws  the  specified  number  of  quarters 
of  an  ellipse  defined  by  its  center  and  one  endpoint  of 
each  axis.  The  ending  slooe  is  returned  in  se.  Present 
beam  position  is  taken  as  the  endooint  of  one  axis  and 
drawing  starts  ,  in  the  direction  of  the  other  axis 
endooi  nt . 

a  x  coordinate  of  center 

b  v  coordinate  of  center 

xe  -    x  coordinate  of  other  axis  endpoint 

ye  -    y  coordinate  of  other  axis  endooint 

g   -    number  o  *  additional  quarters 
0:     one  Quarter  only 
1 :     semi -e 1 1 i  pse 

2:     two  additional  quarters*  total  three  quarters 
3:     f ul 1  el  1 iose 

se  -    address  of  floating  point  variable  where  endina  slope 
can  be  returned    , 

SEE  ALSO: 

cgelpsa,  cgelose*  cgvelog 
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cqerase 


cgerase 


NAME: 

cqerase  -  erase  screen 

SYNOPSIS: 

cgerase  (e*  w) 
i  nt  erw>' 


DESCRIPTION: 

This  routine  erases  the  screen.  There  are  two  means 
of  doing  this.  Full  screen  erase  or  a  selective  erase 
can  be  used.  In  a  selective  erase  the  item  to  be  erased 
is  redrawn  after  this  routine  is  called  to  effect  the 
erasure . 

e   -    erase  screen  f 1 ao 

0:     do  not  full  screen  erase 
1:     full  screen  erase 

w   -    writting  mode  flag 

0:      return  in  normal  writtinq  mode 
1:     return  in  selective  erasure  mode 
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C  a  f  i  n  i 


caf  i  ni 


NAME: 

c  g  f  i  n  i  -  close  files 

SYNOPSIS: 

cgf  i  n i  (  f  n ) 
char  fn[)  ; 

DESCRIPTION: 

This  routine  closes  all  files  that  cgstart  opens. 
fn  -    filename  used  previously  when  callinq  cgstart 

SEE  ALSO: 
cgst  art 


S3 


cqhome 


cahome 


NAME: 

cghome  -  initialize 
SYNOPSIS: 

cghome ( ) 

DESCRIPTION: 

This  routine  performs  display  initialization  with 
cursor  in  lower  left-hand  corner  of  screen?  character 
size=2f  picture  scale=l#  and  rotation  angle=0.  Offsets 
are  zeroed  and  terminal  is  in  qraohic  mode. 

SEE  ALSO: 
cgst  art 
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cgi  nofm 


cgi  npf  m 


NAME: 

cginpfm  -  set  input  form 

SYNOPSIS: 

cqinofm(o) 
i  nt  o; 


DESCRIPTION: 

This  routine  sets  the  mode  in  which  coordinate 
parameters  will  be  expressed.  They  may  be  expressed  in 
either  Cartesian  coordinates  (absolute)r  where 
coordinates  are  relative  to  a  fixed  oriain?  or  in 
relative  coordinates?  where  the  beam  oosition  is  used  as 
the  origin  so  that  adjustinq  one  point  also  adjusts  all 
subsequent  Doints. 

o   -    selection  indicator 

0:     absolute  coordinates 
1:     relative  coordinates 
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cqkbd 


cgkbd 


NAME: 

cqkbd  -  enable/disable  keyboard 

SYNOPSIS: 

cgkbd (e ) 
int  e  ? 


DESCRIPTION: 

This  routine  turns  the  alohanumeric  keyboard  on  and 
off.  It  is  automatically  called  by  cqrdkey  to  turn  the 
keyboard  on?  however,  the  user  must  utilize  this  call  if 
he  desires  the  keyboard  d i sab  1 eda f t er  reading. 

e   -    action  flaa 

0:     disable  keyboard 
1:     enable  keyboard 


SEE  ALSO: 
cgrdkey 


5b 


cql ine 


cal ine 


NAME: 

cal ine  -  draw  a  line 

SYNOPSIS: 

c  g 1 ine(x,y) 
i  nt  x»y? 

DESCRIPTION: 

This  routine  draws  a  line  from  the  oresent  position 
of  the  beam  to  the  endooint  defined  bv  the  coordinates 
x  /  y . 

x       x  coordinate  of  the  endpoint 

y       y  coordinate  of  the  endpoint 

SEE  ALSO: 
cgv 1 ine 
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cqmove 


cqmove 


NAME: 

cqmove  -  oosition  cursor 

SYNOPSIS: 

cqmove ( x , y ) 
i  nt  x , y ; 


DESCRIPTION: 

This   routine   moves   the   beam   to   the 
position  without  drawina. 

x  coordinate  of  the  endpoint 

y  coordinate  of  the  endooint 

SEE  ALSO: 
cqvmove 


indicated 
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cgpf  k 


cgpf  k 


NAME: 

cgpfk  -  enable/disable  program  function  keys 

SYNOPSIS: 

cgpf  k (e) 
int  e; 


DESCRIPTION: 

This  routine  turns  the  program  function  keyboard  on 
and  off.  It  is  automatically  called  by  cgrdpfk  to 
enable  the  function  keys*  but  must  be  called  by  the  user 
when  he  desires  to  diable  the  function  keys. 

i   -    ac  t  i  on  f 1 ag 

0:     disable  orogram  function  keys 
1:     enable  program  function  keys 


SEE  ALSO: 
cgrdpf  k 
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cqpoi  nt 


cgooi  nt 


NAME: 

cgpoint  -  draw  a  ooint 

SYNOPSIS: 

cgpoi  nt ( x , y ) 
i  n  t  x  /  y  ; 


DESCRIPTION: 

This   routine   draws   a 
position. 

x   -    x  coordinate  of  the  ooint 

y   -    y  coordinate  of  the  ooint 

SEE  ALSO: 

cqvoo i  n t 


Doint   at    the    specified 
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cardacc 


cgrdacc 


NAME: 

cgrdacc  -  read  accumulator 

SYNOPSIS: 

cgrdacc (ac ) 
int  *ac; 

DESCRIPTION: 

This  routine  reads  the  Conoaraph i c- 1 2    accumulator. 

ac  -    address  of  an  inteaer  variable  where  the   value   from 
the  accumulator  can  be  returned 

SEE  ALSO: 
cgrdreg 
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cardcsr 


cgrdcs  r 


NAME: 

cqrdcsr  -  read  cursor  position 

SYNOPSIS: 

cgrdcsr (x,y) 
i  nt  *x , *y ; 


DESCRIPTION: 

This  routine  reads  the  Conoaraphic-12  present  cursor 
position.  An  additional  side  effect  is  that  the  cursor 
is  turned  off  prior  to  reading  and  turned  on  after 
read  i  ng . 

x   -    address  of  an  inteaer  variable  where  the  x  coordinate 
can  oe  returned 

y   -    address  of  an    integer  variable  where  the  y  coordinate 
can  be  returned 


SEE  ALSO: 

cgc  rs  r ,  cgrdreg 
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carddsw 


cgrddsw 


NAME: 

cqrddsw  -  read  display  status  word 

SYNOPSIS: 

cgrddsw (ds) 
int  *ds; 


DESCRIPTION: 

This  routine  reads  the  Conoaraph i c-1 2  display  status 
word. 

ds  ■    address  of  an  integer  variable  where  the   value   from 
the  display  status  word  can  be  returned 

The  bits  have  the  followinq  meanings  (low  order  bit   0) 

0 :  italics 

1:  machine  check 

3:  pfk  reauesting  attention 

7,6:  mode  of  the  display 

00  -    alphanumeric 

0 1  -    t  emDl ate 

10  -    short  grapH  i  c 

1  1        1 ong  graoh  i  c 

10-8:  reflection  state 

11:  graphic  incut  flag 

15:  TTY  switch  setting 


SEE  ALSO: 
cgrdreg 
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cardf bs 


cgrdf bs 


name: 

cgrdfbs  -  read  font  base 

SYNOPSIS: 

cgrdfbs(fb) 
i  n  t  *  f  b  ; 


DESCRIPTION: 

This  routine  reads  the   address   in   the   font   base 
register  for  the  memory  o*  the  Conograph i c- 1 2 . 

fb  -    address  of  an  inteaer  variable  where  the  address  from 
the  font  base  register  can  be  returned 


SEE  ALSO: 

cgrdmem,  cgwrrnem,  cardrea 
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cqrdkey 


cgrdkey 


NAME: 

cqrdkey  -  read  keyboard  characters 

SYNOPSIS: 

cgrdkey (k,n) 
i  nt  n; 
char  *k; 


DESCRIPTION: 

This  routine  reads  a  specified  number  of   characters 
from  the  Conoqraphic-12  alphanumeric  kevboard. 

n   -    number  of  characters  to  be  read 

k   -    character  array  of  at  least  size  n   where   characters 
can  be  returned 


SEE  ALSO: 

cgkbd,  c'qrdrea 
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cgrdmem 


eg  rdme* 


NAME: 

cgrdmem  -  read  memory 

SYNOPSIS: 

cgrdmem (b»n,w) 
i  nt  b>n,*wr 


DESCRIPTION: 

This  routine  loads  the  font  base  register  with  the 
suDolied  value  and  reads  the  specified  number  of  words 
f  rom  memo  ry, 

b   -    value  to  be  loaded  into  the  font  base  register 

n   -    number  of  words  to  be  read?  this  is   limited   to   the 
range  zero  to  4096 

w   -    array    of  at  least  size  n  whe^e  the  words  from   memory 
can  be  returned 


SEE  ALSO: 

cgwrmem,  cgrdfbs»  cardrea 
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cardof  f 


cgrdof  f 


NAME: 

cqrdoff  -  read  offset 

SYNOPSIS: 

cgrdof  f ( x , y ) 
i  nt  *x  >  *y  ? 


DESCRIPTION: 

This   routine   reads   the    current    Conograoh i c- 1 2 
of  f set  . 

x   -    address  of  an  inteoer  variable  where  the  x  coordinate 
can  be  returned 

y   -    address  of  an  integer  variable  where  the  y  coordinate 
can  be  returned 


SEE  ALSO: 
cqrdreg 
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cgrdof k 


cgrdpf k 


NAME: 

cgrdpfk  -  read  program  function  keys 

SYNOPSIS: 

cgrdpf  k(k,n) 
i  nt  n; 
char  *k; 


DESCRIPTION: 

This  routine  reads  a  specified   number   of   keycodes 
from  the  program  funtion  keyboard. 

n   -    number  of  keycodes  to  be  read 

k   -    character  array  of  at  least  size  n  where  keycodes  can 
be  returned 


SEE  ALSO: 

caofkf  cgrdrea 
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cgrdreg 


cgrdreq 


NAME: 

cgrdreg  -  read  all  the  registers 
SYNOPSIS: 

cgrdregC ) 


DESCRIPTION: 


Thi 

into 
f ol 1 ow  i 
0: 

1: 
2: 

3: 
a: 
5: 
6: 

7: 
8: 
9: 


s  rout  i  ne  reads  a  1 1 

the   array   cgreg. 

ng  order: 

x  dos  i  t  i  on 

v  oos  i  t  i  on 

x  of  f set 

v  offset 

ob  j  ec  t  scale 

oicture  scale 

graoh  i  c  scale 

font  base  reaister 

display  status  word 

aceumu 1  at  or 


the  Conoaraph  i  c-t  2.       reqisters 

They   are   arranged   in   the 


SEE  ALSO: 

cgrdcsr,  cgrdoff/  cgrdsclr  cgrdfbs/  corddsw,  cgrdacc 


69 


cqrdsc 1 


cgrdsc 1 


NAME: 

cgrdscl  -  read  scales 

SYNOPSIS: 

cqrdsc 1 (p#o> g) 
i  nt  *Dr  *Of  *a; 


DESCRIPTION: 

This   routine   reads   the   scale   registers   of   the 
Conographic-12. 

p   -    address  of  an  inteqer  variable  where  the   value   from 
the  picture  scale  register  can  he  returned 

o   -    address  of  an  integer  variable  where  the   value   from 
the  object  scale  register  can  be  returned 

g   -    address  of  an    integer  variable  where  the   value   from 
the  graDhic  scale  register  can  be  returned 


SEE  ALSO: 
cgrdreg 
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cqst  art 


cgst art 


NAME: 

cgstart  -  open  files  and  initialize 

SYNOPSIS: 

cgst  art ( f n ) 
char  f  n  f ]  ; 


DESCRIPTION: 

This  routine  must  be  called  prior  to  any  other.    If 

the   parameter   fn  is  present*  an  output  file  is  created 
of  the  display  commands  that  follow?  otherwise  the  files 

associated    with    the    Conoqraph i c- 1 2  are         opened. 

Initialization  performed  by  this  routine  is  identical  to 
that  done  by  cghome. 


fn  -    filename  of  file  to  he  created  vice 
ConograDh  i  c- 1 2 


writing   to   the 


SEE  ALSO: 

cghome  t    caf  i  n  i 
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catpl t 


cqtol t 


NAME: 

cgtolt  -  emit  character  strinq  in  template  mode 

SYNOPSIS: 

cqtpl t (a) 
char  a  []  ; 


DESCRIPTION: 

This  routine  places  the  terminal  in  template  mode 
and  then  sends  a  character  string  to  the  terminal.  It 
returns  the  beam  position  to  a  ooint  one  line  down  from 
the  previous  nosition  and  returns  the  terminal  to  the 
previous  qraohic  mode. 


nul  1 -t  erm  i  nat  ed 
Conoqraohic-12 


character   strinq   to   be   sent 


to 


SEE  ALSO: 
coa 1  oh 
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cgvcord 


cqvcord 


NAME: 

cgvcord  -  define  virtual  coordinates 

SYNOPSIS: 

cgvcord(lx,ly,rx,ryfd) 

i  n  t  d ; 

f 1  oat  1 x  f 1 y ,  rx , ry ; 

DESCRIPTION: 

This  routine  defines  the  virtual  coordinates  by 
spec i f i ng  the  lower-left  point  of  the  screen  and  the 
uDper-right  point  of  the  screen.  Virtual  coordinates 
are  still  affected  by  scalina  and  offset.  Definition  of 
the  virtual  coordinates  with  respect  to  the  screen 
assumes  a  unity  scalinq  and  zero  offset. 

lx  -  minimum  x  virtual  coordinate  on  the  screen 

ly  -  minimum  y  virtual  coordinate  on  the  screen 

rx  -  maximum  x  virtual  coordinate  on  the  screen 

ry  -  maximum  y  virtual  coordinate  on  the  screen 

d   -    distortion  flaa 

0:     do  not  distort 
1:     oemit  distortion 
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cave  r22 


cgvc  r22 


NAME: 

cqvcp22  -  curve  given  endDoints  and  slooes 

SYNOPSIS: 

cgvcr22(xfy,sbf se) 
f 1  oat  x  t  y  r sb#  se? 

DESCRIPTION: 

This  routine  draws  a  curve  when  given  two  points  on 
the  desired  curve  and  the  slooes  associated  with  these 
two  points.  The  beginning  Doint  of  the  curve  is  the 
present  oosition  of  the  beam.  The  coordinates  x,y 
define  the  endooint.  The  slooe  of  the  beginning  ooint 
is  defined  by  sb.  The  slope  of  the  endooint  is  given  by 
se. 

x        x  virtual  coordinate  of  the  endooint 

y        v  virtual  coordinate  of  the  endooint 

sb  -    slooe  of  the  curve  at  the  beginnina  ooint 

se  -    slooe  of  the  curve  at  the  endpoint 


SEE  ALSO: 

cgcr22,   cgcr3b, 
cgvc  r3i ,    cgvc  r3m 


cac  r3e» 


cac  r 3i , 


coc  r 3m, 


cave  r3e  * 


la 


cqvc  r3b 


cqvc  r3b 


NAME: 

cgvcr3b  -  curve  given  three  points  and  beginning  slope 

SYNOPSIS: 

cgvcr3b(g,h,x,y,sb*se) 
float  gfh,x,y,sb»*se; 

DESCRIPTION: 

This  routine  draws  a  curve  when  given  three  points 
and  the  s^ooe  at  the  beainning  point.  The  beginning 
point  is  defined  by  the  present  position  of  the  beam. 
The  coordinates  of  the  intermediate  point  are  given  by 
g/h.  The  endpoint  is  shown  by  the  coordinates  x,y.  The 
slope  at  the  beginning  point  is  defined  by  sb.  The 
address  where  the  value  of  the  ending  slope  will  be 
returned  is  shown  by  se. 

g  x  virtual  coordinate  of  intermediate  point 

h  y  virtual  coordinate  of  intermediate  point 

x  x  virtual  coordinate  of  the  endpoint 

y  y  virtual  coordinate  of  the  endooint 

sb  -  slooe  of  the  curve  at  the  beainning  point 

se  -    address  of  floatina  point  variable  where  endina  slope 
can  be  returned 


SEE  ALSO: 

cgcr22,   cgcr3b»   cgcr3e» 
cgvcr3e#  cgvcr3ir  cavcr3m 


cgcr3i,    cacr3m,    cgvcr?2/ 
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cave  r3e 


cgvc  r3e 


NAME: 

cgvcr3e  "  curve  given  three  points  and  ending  slope 

SYNOPSIS: 

cgvcr3e(g#h,XfVfSe) 
float  g»h,x>y»se; 

DESCRIPTION: 

This  routine  draws  a  curve  when  given  the 
coordinates  of  three  points  and  the  slope  at  the 
endpoint.  The  beginninq  point  is  defined  by  the  present 
position  of  the  beam.  The  intermediate  point  is  shown 
bv  the  coordinates  g*h.  The  endpoint  is  defined  by  the 
coordinates  x,y.  The  slope  at  the  endpoint  is  given  by 
se . 

g  x  virtual  coordinate  of  intermediate  point 

h  y  virtual  coordinate  of  intermediate  point 

x  x  virtual  coordinate  of  the  endpoint 

y  y  virtual  coordinate  of  the  endpoint 

se  -    slope  of  the  curve  at  the  endpoint 


SEE  ALSO: 

cgcr22f   cgcr3b/   cacr3e» 
cgvcr3b»  cgvcr3i#  cavcr3m 


cgcr3ir    cacr3m,    cgvcr22, 
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cgvc  r3i 


cgvc  r3i 


NAME: 

cavcr3i  -  curve   given   three   points   and   intermediate 
s  1  ope 

SYNOPSIS: 

cgvcr3i  (g,h , x , y , si  »se) 
float  g, h , x , y , s i , *sei 


DESCRIPTION: 

This  routine  draws  a  curve  when  given  three  points 
and  the  slope  at  the  intermediate  point.  The  beginning 
point  is  defined  by  the  present  position  of  the  beam. 
The  intermediate  point  is  qiven  by  the  coordinates  g>h. 
The  endDoint  is  defined  by  the  coordinates  x#y.  The 
slooe  at  the  intermediate  point  is  given  by  si.  The 
address  where  the  value  of  the  ending  slope  will  be 
returned  is  shown  by  se. 

g       x  virtual  coordinate  of  intermediate  point 

h        y  virtual  coordinate  of  intermediate  point 

x       x  virtual  coordinate  of  the  endpoint 

y        y  virtual  coordinate  of  tne  endpoint 

si  -    slooe  of  the  curve  at  the  intermediate  point 

se  -    address  of  floating  point  variable  where  endincj  slope 
can  be  returned 


SEE  ALSO: 

cacr22,   cgcr3b#   cgcr3e, 
cgvcr3e»  cgvcr3m 


cgcr3ir    cacr3m,    cavcr22r 
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cgvc  r3m 


cgvc  r3m 


NAME: 

cgvcr3m  -  curve  given  three  points*  one  at  the   relative 

maximum 

SYNOPSIS: 

cgvcr3m(g,h#  x , y , se) 
float  g>  h , x , y , *se? 


DESCRIPTION: 

This  routine  draws  a  curve  when  given  three  points 
where  the  slooe  at  the  intermediate  Doint  is  eaual  to 
the  slope  of  the  chord  joining  the  endooints.  The 
beginning  ooint  is  defined  by  the  present  position  of 
the  beam.  The  intermediate  ooint  is  shown  by  the 
coordinates  g»h.  The  endpoint  is  defined  by  the 
coordinates  xry,  The  address  where  the  value  of  the 
ending  slooe  will  be  returned  is  shown  by  se. 

g  -    x  virtual  coordinate  o*  intermediate  point 

h  -    y  virtual  coordinate  of  intermediate  point 

x  x  virtual  coordinate  of  the  endpoint 

y  y  virtual  coordinate  of  the  endpoint 

se  -    address  of  floating  ooint  variable  where  endinq  slope 
can  be  returned 


SEE  ALSO: 

cgcr22,      cgcr3b, 
cqvcr3e»  cgvcr3i 


cgcr3e*    cacr3i,    cqcr3m,    cavcr?2r 
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cqvdrwa 


cgvdrwa 


NAME: 

cgvdrwa  -  set  orientation  in  virtual  coordinates 

SYNOPSIS: 

cgvdrwa(Srarr,x,y,f,ac>av) 
i  nt  (*f)()>ac»av»p; 
f 1  oat  S/ a»  x  r  y ; 


DESCRIPTION: 

This  routine  resets  the  orientation  then  calls  the 
user's  function  with  the  two  arguements.  Scaling  is  bv 
means  of  the  Conograph i c- 1 2  hardware  registers  therefore 
limited  to  the  range  of  1/64  to  63  63/64,  Upon  return 
the  previous  orientation  is  restored.  Thus  the  user  is 
provided  with  a  convenient  means  of  recursively  stacking 
the  scale  and  offset  settings. 

scale  to  be  aoplied 

i   -    angle  of  desired  rotation  expressed  in  radians 


r 


0: 
1 : 
2: 
3: 
4: 
5: 
6: 
7: 


reflection  desired 


no  ref 1 ec  t  i  on 
reflect  about 
reflect  about 
ref 1 ec t  about 
reflect  about 


x-ax  t  s 
y  -  a  x  i  s 
both  axes  r 
o  i  /  4  line 
pi/2  rotation  counterclockwise 
pi/2  rotation  clockwise 
reflect  about  3/4  pi  line 


(oi  rot  at  i  on ) 


x  x  virtual  coordinate  which  will  correspond  with 
present  beam  position  and  be  the  center  of  reflection 
and  rotation 

y  -  y  virtual  coordinate  which  will  correspond  with 
present  beam  position  and  be  t^e  center  of  reflection 
and  rot  at  i  on 

f   -    user  defined  function 

ac  -    first  arquement  for  user  function 

av  -    second  arquement  for  user  function 
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SEE  ALSO: 

cqvdrwr,  cgdrawa*  cadrawr 
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cgvdrwr 


cgvd  rwr 


NAME: 


cgvdrwr   -    set    orientation    relative 
orientation  in  virtual  coordinates 


to 


present 


SYNOPSIS: 

cgvdrwr(s,a,r,x,y,f,ac»av) 

int  (*f )()»ac>av,r;M float  s  >  a  >  x  r  y ; 


DESCRIPTION: 

This  routine  sets  a  new  orientation  relative  to  the 
present  orientation  then  calls  the  user's  function. 
Thus  the  reflections*  rotations  and  scalina  are 
cummulative.  For  best  results  it  is  recommended  that 
most  scaling  factors  be  l#  if  the  hardware  scaling 
provided  here  is  insufficient  it  is  recommended  that 
scaling  be  effected  by  utilizing  another  call  to  cgvcord 
(note:  there  is  not  automatic  stacking  of  cgvcord 
settings).  Upon  return  the  present  orientation  is 
restored. 

scale  to  be  aDolied 


angle  of  desired  rotation  expressed  in  radians 


reflection  desired 

0  :  no  reflection 

1 :  ref 1 ec t  about 

2:  reflect  about 

3:  ref 1 ec  t  about 

4:  reflect  about 

5 :  Di /2    rot  at  i  on 

6:  pi/2  rotation  clockwise 

7:  reflect  about  3/4  Di  line 


x -ax i s 
y-ax  i  s 
bot  h  axes , 
p  i / H     line 
counterclockwi  se 


(o  i  rot  at  i  on  ) 


x  virtual  coordinate  which  will  correspond  with 
present  beam  position  and  be  the  center  of  reflection 
and  rotation 


y  virtual 
oresen t  beam 
and  rotation 


coordinate   which   will   correspond   with 
position   and  be  the  center  of  reflection 


user  defined  function 
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ac  -    first  arguement  for  user  function 
av  -    second  arguement  for  user  function 

SEE  ALSO: 

cgvdrwar  cgdrawa>  cadrawr 
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cqve 1 pq 


cgvel pq 


NAME: 

cgvelpq  -  draw  ellipse  quarters  in  virtual  coordinates 

SYNOPSIS: 

cgvelpq(a*b/xefye>afSe) 

i  nt  q; 

float  a ,b , xe fye , *se7 

DESCRIPTION: 

This  routine  draws  the  sDecified  number  of  quarters 
of  an  ellipse  defined  by  its  center  and  one  endpoint  of 
each  axis.  The  ending  sloDe  is  returned  in  se.  Present 
beam  position  is  taken  as  the  endpoint  of  one  axis  and 
drawing  starts  in  the  direction  of  the  other  axis 
endpoi  nt . 

a  x  virtual  coordinate  of  center 

b  y  virtual  coordinate  of  center 

xe  -    x  virtual  coordinate  of  other  axis  endooint 

ye  -    y  virtual  coordinate  of  other  axis  endpoint 

q   -    number  of  additional  quarters 
0:     one  quarter  only 
1  :     sem  i -el  1 i  ose 

2:     two  additional  quarters/  total  three  quarters 
3:     full  e 1 1 i  pse 

se  "    address  of  floating  ooint  variable  where  endinq  slope 
can  be  returned 

SEE  ALSO: 

cqelosa*  cqelpse*  caelosq 
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cgvl i  ne 


cgvl i  ne 


NAME: 

cgvline  -  line  in  virtual  coordinates 

SYNOPSIS: 

cgv 1 i  ne ( x  »  y ) 
f 1  oat  x , y ; 

DESCRIPTION: 

In  this  routine  the  beginning  point  is  defined  as 
the  present  position  of  the  beam.  The  endpoint  is 
defined  by  the  coordinates  x,y. 

x        x  virtual  coordinate  of  the  endpoint 

y       y  virtual  coordinate  of  the  endpoint 

SEE  ALSO: 
cal i  ne 
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cgvmove 


cgvmove 


NAME: 

cgvmove  -  move  in  virtual  coordinates 

SYNOPSIS: 

cgvmove ( x , y ) 
float  x  f  y ; 


DESCRIPTION: 

This   routine   moves   the   beam   to   the 
position  without  drawinq. 

-    x  virtual  coordinate  of  the  endpoint 

y  virtual  coordinate  of  the  endpoint 

SEE  ALSO: 
cgmove 


indicated 


85 


cgwrmem 


cgwrmem 


NAME: 

cgwrmem  -  write  to  memory 

SYNOPSIS: 

cgwrmem (b / n  , w ) 
i  nt  b r n , *w? 

DESCRIPTION: 

This  routine  writes  the  specified  number  of  words 
into  the  Conograph i c- 1 2  font  memory  starting  at  the 
supplied  base  address. 

'      -    value  to  be  loaded  into  the  font  base  register 

i   -    number  of  words  to  be  written 

i   -    array  of  at  least  size  n  where  the  words   for   memory 
are 

SEE  ALSO: 
cgrdmem 
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